探索React源码的全局模块系统

也可以在这里看：https://leozdgao.me/react-global-module-system/

扫了几眼react的源代码（0.14-stable分支），发现一个有趣的现象，比如如下这段代码：

var ReactDOM = require('ReactDOM');
var ReactDOMServer = require('ReactDOMServer');
var ReactIsomorphic = require('ReactIsomorphic');

var assign = require('Object.assign');
var deprecated = require('deprecated');

熟悉 node.js 的 CommonJS 模块系统的话，我们知道有如下3种情况：

• 依赖一个原生模块（native module），比如fs模块或者是events模块。

• 以 '/'、'./' 或 '../' 开头，代表文件路径，比如用 require('./my-module') 来获取当前目录下 my-module.js 文件所导出的模块。

• 否则，则从当前目录的 node_modules 文件夹中找，如果没有找到，就从父目录的 node_modules 文件夹中找，递归到根目录的 node_modules 文件夹。

根据以上规则，例子中的代码显然属于第三种情况，然而实际上 ReactDOM 或者 Object.assign 这几个模块并不属于 node_modules 文件夹，它们其实也存在与本地的源代码中，比如对应的 Object.assign 模块实际上位于 /src/shared/stubs/Object.assign.js。

引用 google groups 上一个回答，这是它们的 全局模块系统。出于好奇，决定探索一番，看看这是如何实现的。

工作流

首先的一点是，由于它的模块依赖方式和我们熟悉的方式并不吻合，所以我们需要探索这个部分的工作流，看这个全局模块系统是如何融入整个开发过程中的。

从源代码里知道到了这部分任务，是定义在 gulpfile.js 中的 react:modules 任务：

• src 目录下的代码会被编译

• 编译完后代码结构被扁平化

• 所有代码中的 require 会被转化为相对路径的形式

也就是说，本来这样的目录：

- src
  - lib
    - ReactElement.js
    - ReactDOM.js
  - index.js

变成了这样：

- build 
  - index.js
  - ReactElement.js
  - ReactDOM.js

如果 index.js 中本来有 require('ReactElement')，最后就被编译为 require('./ReactElement') 了。

正是有这样的一个步骤，让这个全局模块系统得以工作，再思考下其中的细节，这个编译过程需要做哪些东西：

• 用于标记模块的标识符

• 标识符与对应文件路径的Map，用于替换require的模块标识

好的，顺着这个思路在来看看代码，我们发现主要是 rewrite-modules 这个babel插件来负责这个事情，这是Facebook的自定义babel插件，要了解如何编写一个自定义babel插件的话，可以参考这篇文档。

在 rewrite-modules 的代码中可以发现一个叫做mapModule的函数，负责 require() 中模块标识的替换，其中模块共有两个来源：

• 由于Facebook巨大的codebase的关系，一些工具函数在fbjs这个项目里，包括什么 invariant 函数或者是 warning 函数这些

• 当前项目的本地模块

而fbjs这个项目在编译的时候会生成一个 module-map.json 的文件，来表示唯一模块标识符和正常方式引用模块的标识符之间的映射，那么这个文件是如何生成的呢？

从 fbjs/scripts/gulp/module-map.js 的代码来看，是用了 @providesModules <moduleName> 来标记模块，比如 areEqual.js 这个文件的注释中可以发现：

* @providesModule areEqual

并且有一个 prefix 的设置，设置为 fbjs/lib/，所以如果我有如下代码：

require('areEqual')

则会被编译成：

require('fbjs/lib/areEqual')

不过奇怪的是，在React的源代码中也可以发现 @providesModules 标记，但在 React 源代码编译的工作流中，并没有发现解析这个标记的逻辑，它的逻辑是：如果模块在 fbjs 的 moduleMap 中找不到，则直接加上 ./ 的前缀，也就是说：

require('ReactElement')

直接变成：

require('./ReactElement')

我也尝试修改 React 源代码中的 @providesModules，对编译结果没有影响。至于这里为什么会有两种不同的逻辑，我也不清楚。

很清楚了，开始的时候也说过了，那个负责编译源代码的 gulp task 中，有扁平化这个源代码的目录结构的任务，那么所有本地模块，也都可以被正确引用到了。

Commoner

我还发现一个工具，就是这个 Commoner 了，它可以编译你的代码，解析你注释中的 @providesModules，输出一个扁平化的目录，文件名为各自的模块标识符的名字，require() 也会被替换成正确的相对路径，有兴趣的话可以了解下这个工具，好像也是 reactjs 这个 organiztion 里的，不过不知道为什么不用了，估计是因为要迎合 babel 生态的关系吧，react 的项目中用 babel 插件代替了它。

一些思考

大致考虑了一下，为什么FB的团队会整出这个所谓的『全局模块系统』，我觉得还是和它巨大的 codebase 是有关的，什么 React、RN、Flow、Relay 等等，那么必然会有一些公共的工具库，而且像 React 一个项目本身的 codebase 也很大了，所以要维护各种相对路径，很吃力，但有利有弊吧：

好处：

• 不需要维护模块之间的相对路径

• 可以更放肆地调整目录结构而不对代码产生影响

缺点：

• 模块必须通过唯一标识标记而不再取决与文件路径，所以必须保证不能重名

• 要对模块很熟悉，不然光看到一个名字，然后找不到对应的文件在哪里

其实还是挺有意思的，在探索的过程也顺便了解了babel插件的编写，过了元旦要开始新的项目了，准备尝试尝试，把它加进工作流中去。